제스처 영역 위젯
경로: 위젯 갤러리> 버튼> 기타
제스쳐 영역 위젯은 제스쳐 이벤트를 생성하는 핫스팟 버튼입니다.
제스쳐 이벤트 | 설명 |
---|---|
OnSwipeLeft OnSwipeRight |
옆으로 쓰는 제스쳐가 감지될 때 이벤트가 나타납니다 |
OnPinchOpen OnPinchClose |
꼬집는 제스쳐가 감지될 때 이벤트가 나타납니다. |
RotateClockwise RotateAntiClockwise |
회전시키는 제스쳐가 감지될 때 이벤트가 나타납니다. |
OnPan OnPinch OnRotate |
제스처가 감지되는 동안 나타나는 이벤트들. 자바스크립트만 이러한 이벤트를 처리할 수 있고, 개발자는 자바스크립트 코드를 통해 제스쳐 이벤트를 선호하는 대로 관리할 수 있습니다. 경고: 멀티터치 입력이 가능한 HMI 장치에서만 OnPinch와 OnRotate 이벤트를 생성할 수 있습니다 |
OnPan
boolean onGesturePan(me, eventInfo)
이 이벤트는 영역 내의 한 지점이 눌려지고 선형으로 움직이는 것이 감지되었을 때 발생합니다.
파라미터 | 설명 |
---|---|
me | 이벤트를 작동시키는 객체 |
eventInfo |
id = 제스쳐 아이디, 서로 다른 제스쳐를 식별하기 위해 사용됩니다. running = 제스쳐가 완료되었다는 것을 알리기 위해 전달된 마지막 이벤트를 제외하고는 참(true). dx = 초기에 터치한 위치에서 X축 방향으로 움직인 스크린 픽셀 단위의 총 거리. dy = 초기에 터치한 위치에서 Y축 방향으로 움직인 스크린 픽셀 단위의 총 거리. |
OnPinch
boolean onGesturePinch(me, eventInfo)
이 이벤트는 영역 내의 두 지점이 눌려지고 선형으로 움직이는 것이 감지되었을 때 발생합니다.
파라미터 | 설명 |
---|---|
me | 이벤트를 작동시키는 객체 |
eventInfo |
id = 제스쳐 아이디, 서로 다른 제스쳐를 식별하기 위해 사용됩니다. running = 제스쳐가 완료되었다는 것을 알리기 위해 전달된 마지막 이벤트를 제외하고는 참(true). dx = 초기에 터치한 위치에서 X축 방향으로 움직인 스크린 픽셀 단위의 총 거리. 두 손가락 사이의 거리를 나타냅니다. 양의 값은 거리가 증가했음을 의미하고 음의 값은 거리가 감소했음을 의미합니다. 이 (증가/감소)량을 줌 값을 제어하기 위해 사용할 수 있습니다. dy = X축 방향으로 움직인 스크린 픽셀 단위의 총 거리(dx를 참조하십시오). |
OnRotate
boolean onGestureRotate(me, eventInfo)
이 이벤트는 영역 내의 두 지점이 눌려지고 회전하는 움직임이 감지되었을 때 발생합니다.
파라미터 | 설명 |
---|---|
me | 이벤트를 작동시키는 객체 |
eventInfo |
id = 제스쳐 아이디, 서로 다른 제스쳐를 식별하기 위해 사용됩니다. running = 제스쳐가 완료되었다는 것을 알리기 위해 전달된 마지막 이벤트를 제외하고는 참(true). drot = 이전 이벤트 이후 추가된 각도(0/360). trot = 전체 움직임 동안 추가된 총 각도(0/360). 양의 값은 시계 방향을 음의 방향은 반시계방향을 의미. |
제스처 이벤트 패스스루
제스쳐 객체로 덮인 위젯(예: 버튼 또는 슬라이더)을 사용하려면, 200밀리초 동안 위젯을 눌러서 컨트롤을 아래에 깔린 객체로 이동시켜야 합니다. 아래에 깔린 객체에 명령을 보낼 때까지 기다려야 하는 시간은 고급 속성 보기에서 “제스쳐 패스 지연” 파라미터에서 수정할 수 있습니다.
파라미터 | 설명 | ||||
---|---|---|---|---|---|
제스처 패스스루 활성화 |
설정한 지연 시간 후에 제스체 이벤트를 아래에 깔린 객체에 전달할 수 있게 합니다. 손가락으로 계속 누른채로 제스쳐를 실행해야합니다. default = 프로젝트 속성에서 정의한 값을 사용합니다. "프로젝트"를 참조하십시오. true = 제스처 패스스루 활성화 false = 제스처 패스스루 비활성화 |
||||
제스처 패스스루 지연 (ms) |
아래에 깔린 객체에 명령을 전달하기 위해 반드시 기다려야할 시간
|
제스쳐 이벤트를 자바스크립트와 연계해서 사용하는 예
다음은 자바스크립트 코드와 연계해서 제스쳐 이벤트를 사용하여 제스쳐를 식별하고 요청된 액션을 프로그래밍하는 예제가 있습니다
스와이프 제스쳐
“스와이프” 제스쳐를 인식하고 애플리케이션에서 페이지를 변경하는 법.
- 제스쳐 영역 위젯을 페이지에 놓으십시오
- 자바스크립트 함수를 작동시키기 위해 OnPan 액션을 구성하십시오
- 스와이프 제스처를 인식하고 관리하는 자바스크립트 코드를 쓰십시오
핀치 제스쳐
이미지를 이동시키는 “팬” 제스쳐를 인식하는 법.
- 제스쳐 영역 위젯을 페이지의 이미지 위에 놓으십시오
- 자바스크립트 함수를 작동시키기 위해 OnPinch 액션을 구성하십시오
- 핀치 제스처를 인식하고 관리하는 자바스크립트 코드를 쓰십시오
팬 제스쳐
이미지를 이동시키는 “팬” 제스쳐를 인식하는 법.
- 제스쳐 영역 위젯을 페이지의 이미지 위에 놓으십시오
- 자바스크립트 함수를 작동시키기 위해 OnPan 액션을 구성하십시오
- 팬 제스처를 인식하고 관리하는 자바스크립트 코드를 쓰십시오